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The switch details are as follows*- 


Switch Function Off <=1 ) On <«0> 


Slh vdu serial VDU-2K 

Slg keyboard serial LKP-1 


The switches are read once only during a Cold Start. Any 
conbination can be used, which opens the door to the use of 
a serial keyboard with VDU-2K if required. 

The chosen options are displayed within the logo at sign-on 
to confirM the selection. 
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have changed its nane fron BIOSKRNL to BIOS. Also, I have 
changed the nane of DRIVE. ASM to CONFIG. ASM so that it can 
be used for all configurable paraneters, not just drive 
paraneters. Hence, .if changes are nade to the CONFIG.ASM 
file, the generation process is nowj- 

RMAC CONFIG 

LINK BIOS3COS3=BIOS, CONFIG 


One additional benefit that springs fron having no separate 
console files to link is that CPMLDR does not have to be 
reconfigured every tine you change the console type. 
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SPECIFICATION FOR INTERAK CP/M PLUS <U3.0 ) 


The flexibility built in to Interak CP/M Plus neans that it 
can be altered to run on any Interak systen within the 
constraints of the following specifications- 


1.1 MICROPROCESSOR 

The system processor nust be a Z80 or code-conpatible 
device. 


1.2 MEMORY 

At least 32K of contiguous RAM must be available 
starting at 0O00H. 


1.3 FLOPPY DISK CONTROLLER 

The systcM Must utilise the FDC~1 Floppy Disk 
Controller Board addressed as recoMMended by Greenbank 
Electronics in the FDC-1 data sheet. 


1.4 CONSOLE 

Either a serial or Menory-Mapped visual display unit, 
together with a serial or parallel keyboard May be 
used, configuration being achieved by setting 2 dil 
switches on the FDC-1 board. 

The serial vdu and/or serial keyboard Must be addressed 
with the status and data ports, as. 00H and 01H 
respectively. 

The MeMory-Mapped vdu Must be 64 coluMns by at least 
24 lines, with a start address of F000H <eg VDU-2K) 

The parallel keyboard Must be addressed as 40H, bit 7 
being the positive strobe bit. < eg LKP-1 ) 


1.5 PRINTER 

The operating systeM will support a serial listing 
device, addressed with the status port as 02H and the 
data port as 03H. 


1.6 DRIVE FORMAT 


The SystBM drive (A) Must always have the following 
standard forMats- 

Double-sided 
Double density 
512 bytes per sector 
20 sectors per track 
80 tracks per disk 
2 reserved tracks 
256 directory entries 
4k block size 


The other drives <B, C, and D) are sinilarly supplied/ 
but they can be reconfigured to any other fornat, This 
process is explained in The Interak CP/M Plus Technical 
Manual. 



2. 1 OVERVIEW 


CP/M denotes Control PrograM for Microconputers. CP/M 
Version 3.0 (known as CP/M Plus) is the latest in a 
series of enhancements to the original 8 bit CP/M 
operating system. 

CP/M is a single-console operating system, supporting 
up to sixteen users, and providing an environment for 
program construction, storage, editing, and execution. 

The operating system itself is made up of three 
distinct modules; the Basic Disk Operating System 
( BDOS), the Basic Input/Output System (BIOS), and the 
Console Command Processor (CCP). The function of each 
module is discussed more fully in The Interak CP/M Plus 
Technical Manual. 

CP/M executes most commands by loading the appropriate 
file from disk into an area of memory called the 
Transient Program Area. These files are known as 
Transient Commands. A few commands are built into the 
operating system and are consequently known as Built-in 
Commands. 

Reference is made throughout this manual to the System 
Tracks and System Disks. * Any disk designed to run in 
drive A has two reserved tracks ( in the case of 
Interak) which contain the necessary loaders and the 
Console Command Processor. Such a disk is referred to 
as a System Disk, and its first two tracks are referred 
to as the System Tracks. 


2.2 FILE REFERENCES 

CP/M provides rapid access to data through a 
comprehensive file management sub-system. A file 
reference consists of a filename and an optional 
filetype, separated by a full-stop, eg; 

DIR.COM LETTER. 1 SHOPPING.LST 

A filename may be up to eight characters long, and a 
filetype up to three characters long but neither must 
contain any of the following special characters; 

< )C3( )/\l., ; ;«?♦-% 

All alphanumerics and the remaining special characters 
are allowed. 


Filctypes are sonewhat arbitrary, but in Many cases 
software is dependant on certain filetypes for correct 
operation. For exaMple, coMnand files Must have a 
filetype COM. 

AMbiguous file references May be used to access batches 
of files with partly coMMon filcnaMes or filetypes. 
Wildcards are used for this purpose, the ■?■ replaces 
single characters and the replaces Multiple 
characters. 


2.3 COLD START 

When you switch on your Interak or operate the reset 
switch, only the systeM Monitor is active. To load CP/M 
Plus, a SysteM Disk Must be present in drive A and the 
Boot <B) coMMand Must be entered froM the keyboard. 

The sign-on display gives the following inforMation 
about the current configuration of the systeM*. 

- the start address and size of the BIOS. 

- the start address and size of the BDOS. 

- the aMount of free MeMory space available for 
transient prograM use. 

- the BIOS version nuMber. 

- the selected type of vdu and keyboard, displayed 
within the logo. 


If all is well, the Console CoMMand Processor is loaded 
and the systcM proMpt 'A>' is displayed. 'A' signifies 
the current default drive. This is your invitation to 
enter a coMMand. 


2. 4 HELP 

One of the best features of CP/M Plus coMpared to its 
predecessors is the Help Utility. Detailed guidance on 
invoking Most coMMands on the distribution disk is 
available by typing: 

HELP <CR> 

at the systeM proMpt, This is the ideal first coMMand, 
and liberal use should be Made of it until faMiliarity 
is gained. 


2. 5 HARDCOPY 


If you have a printer connected to your Interak, and 
you want a hardcopy of what transpires on the vdu, 
enter <CTRL-P> at any tine during the input of a 
connand. The sane action will disable the hardcopy 
output if repeated. 
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INVENTORY 


This section is «in introduction to each file on the 
distribution disk. No attempt has been wade to duplicate the 
detailed information available within the Help Utility, so 
reference should be made to the latter before commands arc 
invoked. 

Files annotated with <DR) are written by Digital Research, 
designed for use on any machine which supports CP/M Plus. 
Those annotated with (GB) are written for Greenbank 
Electronics by K. J. Daley specifically for the Interak 1 
computer. 

Files annotated with <R) are, as far as this implementation 
is concerned, redundant utility files provided by Digital 
Research to aid the creation of the system software. They 
were not used in the creation of Interak CP/M Plus but are 
provided in case anyone wishes to refer to them or produce 
their own system software. 



BD0S3.SPR < DR) 


A relocatable systen file containing the BDOS for a 
non-banked systen. It is combined with BI0S3.SPR by 
GENCPM.COM to produce CPM3. SYS. 


BIOSKRNL.ASM <DR, R ) 

Provided as a model for the creation of the BIOS. 


BIOS. REL (OB) 

This is the Interak Kernel BIOS in relocatable form. It 
is linked to CONFIG.REL to produce BI0S3.SPR which is 
the complete BIOS. 


BI0S3. SPR <GB) 

Created by linking BIOS.REL and CONFIG.REL, this file 
is combined with BD0S3.SPR by GENCPM. COM to create the 
complete CP/M Plus System file CPM3.SYS. 


BNKBD0S3.SPR < DR, R ) 

A relocatable system file containing the BDOS for a 
banked system. It is' combined with RESBD0S3. SPR 
and BNKBI0S3. SPR by GENCPM. COM to produce CPM3.SYS. 


BOOT. ASM <DR, R) 

Provided as a model for the creation of the Cold Boot 
Loader. 


CALLVERS. ASM ( DR) 

An example assembly file aimed at programmers. 


CBLDR. PRG < GB) 

The Cold Boot Loader. Resides in the first sector of 
the first track of System Disks. Loads and executes the 
CP/M Loader. 


CCP.COM < DR) 

The Console Command Processor loaded by the operating 
system at every Warm Start. It usually resides on the 



SystcM Tracks of any disk which needs to run in drive 
A. It is written to the Systen Tracks by GENLDR.COM. 
CCP.COM Must be present on the disk in drive A during 
warM starts. If it is not present, the Message, "Insert 
SysteM Disk in drive A", is given. 


CHARIO. ASM (DR, R) 

Provided as a Model for the creation of a part of the 
BIOS which handles character input and output. 


CONFIG.ASM < GB > 


Assembly file of configuration tables used to custowise 
an Interak system to precise needs, nainly with regard 
to drive fornats. 


CONFIG. REL < GB ) 

Relocatable nodule derived fron CONFIG,ASM by RMAC.COM, 
This nodule is linked to the BIOS,REL file to create 
the conplete BIOS. 


COPYSYS. ASM < DR, R ) 

Intended as the basis for a utility which would copy 
the systen loaders to the Systen Track. It has not been 
used in the Interak 1 inplenentation. A utility called 
GENLDR. COM has been created for this purpose. 


CPM3. LIB (DR, R) 

A library of routines which aid the generation of 
various software tables during the creation of the 
BIOS. 


CPM3.SYS ( GB ) 

This is the file which contains the operating systen 
itself, residing in the data area of all Systen Disks. 
It is produced by GENCPM.COM which brings together the 
BDOS and BIOS. 


CPMLDR. REL (DR) 

Linked with LDRBIOS. REL and CONFIG.REL to create 
CPMLDR.COM. 


CPMLDR. COM ( GB) 

The CP/M loader. This connand file is produced by 
linking CPMLDR. REL with LDRBIOS.REL and CONFIG. REL, and 
its sole task is to load CPM3.SYS fron the Systen 
Tracks into nenory at every Cold Start. It is written 
to the Systen Tracks by GENLDR.COM. 



DATE. CDM < DR ) 


Sets or displays the date used for date-stanping the 
directory entries (optional). 


DEVICE.CDM (DR) 

Utility for displaying and altering the physical to 
logical device assignMent and the attributes of 
peripheral devices. Not yet inplenented in the Interak 
BIOS. 


DIR. COM (DR) 

Displays the nawes and conditionally the attributes of 
files on any specified drive. 


DIRLBL.RSX (DR) 

Extension to the BDOS used with DIR.COM by the 
operating systen. 


DRVTBL.ASM (DR, R ) 

Example drive parameter tables for BIOS construction. 


DUMP. ASM (DR ) 

Assembly file of DUMP.COM intended as an example of 
file handling source code. 

DUMP. COM (DR) 

File dump utility which displays the hexadecimal data 
content of a file in tabular form. 


ECHOVERS. ASM (DR ) 

An example assembly file aimed at programmers. 


ED.COM (DR) 

Digital Researches simple (?l) text editor* 



ERASE.COM (DR) 


Deletes files. Use with care! 


FD1797SD.ASM <DR,R ) 

Exanple Floppy Disk Controller routines for BIOS 
creation. . 


FORMAT. COM (GB) 

Initialises unused floppy disks for use on the Interak 
systen. Reads the necessary format froM the 
configuration of the specified drive. Only the drive 
and the desired Skew Factor Cnornally 2) need to be 
specified. Verification of successful formatting is 
performed after each track is initialised. 


GENCOM.COM (DR ) 

Creates special COM files with attached system 
extensions. Aimed at programmers. 


GENCPM. COM (DR ) 

Combines the BDOS and BIOS after a question and answer 
session to create the CP/M system file CPM3.SYS. The 
screen size and memory availability can be changed with 
this utility. The memory ceiling is set at EFFFH on the 
Distribution Disk. The top page <F000H) can be 
reclaimed if a serial vdu is being used. 


GENLDR.COM ( GB) 

Writes the Cold Boot Loader, the CP/M loader, the logo, 
and the Console Command Processor to the System Tracks 
of the specified disk. All disks intended to run in 
drive A should have these files on the System Tracks. 


GET.COM < DR ) 

Directs the system to take console input from a disk 
file instead of the keyboard. 


HELP.COM < DR ) 

Detailed operational instructions for the (DR) command 
files on the distribution disk. 



HELP.HLP ( DR ) 


Text file for HELP.COM. 


HEXCOM. COM <DR ) 

Generates a COM file froM a HEX file. Used to be called 
LOAD.COM in earlier versions of CP/M. 

HIST. UTL (DR) 

Generates histogran of execution frequency of program 
segments when utilised under SID. COM. 


INITDIR.COM (DR) 

Initialises the directory area to enable date stamping 
of files. Date stamping is optional. 


LIB.COM (DR ) 

Supplied for programmers, manages libraries of object 
modules for inclusion during program assembly. 


LINK.COM (DR ) 

Links relocatable object files to create command files 
for execution. 


MAC. COM (DR) 

Macro Assembler. Assembles 8080 source code files into 
relocatable object files. 


MODEBAUD.LIB (DR, R ) 

Example table for software controlled input/output. 


MOVE. ASM ( DR, R ) 

Example BIOS routines mainly for banked memory. 


PATCH.COM ( DR ) 

Used for installing software patches to the system or 
command files. 



Peripheral Interchange Program. Used for copying data 
to/froM files or devices. 

PORTS. LIB <DR, R) 

Exanple port table for BIOS creation. 

PUT. COM (DR) 

Diverts console or printer output to a file. 


RANDOM.ASM (DR) 

Example assenbly file demonstrating random access to 
file records. 


RENAME.COM ( DR) 

Changes the name of a file or files. 


RESBDOS.SPR (DR, R ) 

Part of BDOS for banked-memory systems. 


RESBD0S3.SPR (DR,R ) 

Part of BDOS for banked-memory systems. 


RMAC.COM (DR ) 

Relocatable macro assembler. 


SAVE.COM (DR ) 

Copies the contents of memory to a file. 


SCB. ASM (DR, R) 

System Control Block used by the operating system but 
also available for use by the BIOS. 


SET. COM (DR ) 


Sets certain attributes of files. 


SETDEF. COM ( DR ) 


Defines disk order for program search^ and console 
display nodes. 

SHOUI. COM ( DR > 

Displays drive characteristics, including disk free 
space. 


SID.COM (DR) 

Krogran debugger for 8080 code. 


SOLO. COM <GB) 

Utility for copying files between disks when only one 
drive is available. 


SUBMIT.COM (DR) 

Allows the execution of a batch of connands previously 
entered into a SUB file. If a file called PROFILE. SUB 
is created, the contents will be executed at Cold Start 
without console intervention. 


TRACE. UTL ( DR) 

Utility used with SID.COM for controlled progran 
execution and trace. 


TYPE. COM < DR) 

Displays the contents of an ASCII file. 


XREF. COM < DR) 

Provides a cross-reference of variables between 
relocatable nodules after linking. 


Z80. LIB (DR) 

Extends the RMAC assenbler to use sone Z80 nnenonics. 


4 COMMAND INSTRUCTIONS FOR GREENBANK UTILITIES 

The following pages contain detailed instructions for the 
execution under CP/M Plus of prograns written specifically 
for Interak. 


4.1 FORMAT.COM 


This utility initialises floppy disks with the current 
fornat of the specified drive. 


Input: FORMAT <CR> 

Response: FORMAT VX. X FOR INTERAK CP/M PLUS <C)K.J.Daley 


Input: 

Response: 

Input: 

Response: 


Type <CTRL-C> at any tine to abort 
Ulhich drive? 

A B C or D 

Skew Factor? Cl-9!1 

1 to 9 < norwally 2 ) 

Ensure the selected drive contains the disk to be fornattcd! 
Type <CR> to begin 


Input: <CR> 

Response: 00 <increnenting track number) 

Change disk and type <F> to repeat, or type <CR> to finish 


GENLDR.COM 


Four systen files Must be present on the default drivet 
CBLDR.PRO CPMLDR.COM LOGO. OAT CCP. COM 

Input! GENLDR 

Responses GENLDR VX. X FOR INTERAK CP/M PLUS <C) K.J.Daley 

(Warning and tcrnination here if any of the four files are m 
Change disk now if writing to default drive 
Destination drive? CA to D, or <CR> to aborts 
Inputs A B C D or <CR> 

Responses Write verified ('Write not verified' if errors occur) 

Change disk and type <G> to repeati or type <CR> to finish 


Inputs 


G or <CR> 


4. 3 


SOLO.COM 


Inputi SOLO 

Response: SOLO VX.X FOR INTERAK CP/M PLUS (C) K.J.Daley 

Solo drive facility now in operation. 

SOLO, the transient prograM for solo-drive operation, is on 
this disk. Once invoked, it regains in operation until the 
next Cold Start. Any forwat can be used on logical drive B, 
by configuring the CONFIG, ASM file and regenerating the 
systen as usual. 


5 CONSOLE CONFIGURATION 
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FURTHER INFORMATION 


The airi of this Manual is to provide users of Interak CP/M 
Plus with enough infornation to run existing software. For 
users who wish to write their own software, Greenbank 
Electronics can supply appropriate prograMMing Manuals by 
Digital Research. 

For users who need to alter the configuration of the 
disk drives, or who require More technical inforMation, the 
Interak CP/M Plus Technical Manual is available. 


